Description

Make wrapped tools able to resolve Headroom-managed rtk without requiring users to manually add ~/.headroom/bin to PATH.

headroom wrap now prepends the managed rtk bin directory to the child process PATH before launching the tool.

Closes #1752

Type of Change

• Bug fix (non-breaking change that fixes an issue)

Changes Made

• headroom/cli/wrap.py: added case-insensitive PATH-key resolution so Windows-style Path entries are updated in place.
• headroom/cli/wrap.py: keeps duplicate prevention on the resolved path key instead of creating a second PATH entry.
• tests/test_cli/test_wrap_helpers.py: added regression coverage for Windows-style env maps and duplicate prevention.

Testing

• Unit tests pass (pytest)
• Linting passes (ruff check .)
• Type checking passes (mypy headroom)
• New tests added for new functionality
• Manual testing performed

Test Output

$ C:\Users\Jayesh\AppData\Local\Programs\Python\Python314\python.exe -m pytest tests\test_cli\test_wrap_helpers.py -k "prepend_rtk_bin_to_path"
3 passed, 37 deselected in 1.14s

$ ruff check headroom\cli\wrap.py tests\test_cli\test_wrap_helpers.py
All checks passed!

Real Behavior Proof

• Environment: Windows 11, PowerShell, Python 3.14, Headroom wrap helper path-prepend flow.
• Exact command / steps: Ran _prepend_rtk_bin_to_path() regression tests against both PATH and Windows-style Path env dictionaries, plus duplicate-path coverage.
• Observed result: Managed rtk bin dir prepends exactly once and updates existing Path key in place without creating a second differently-cased entry.
• Not tested: Full interactive wrapped-shell launch against a live Windows child process in this verification pass.

Review Readiness

• I have performed a self-review
• This PR is ready for human review

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have updated the CHANGELOG.md if applicable

Additional Notes

• Follow-up push already addressed reviewer concern about case-insensitive Windows PATH handling; this body update clears governance/template blockers.